home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / os2 / wpsbk203.arj / READ.ME next >
Text File  |  1993-12-30  |  14KB  |  261 lines
  1.                      Workplace Shell Backup Utility - 2.03
  2.  
  3.  
  4. FOREWORD BY THE AUTHOR - 12/30/93
  5.  
  6. Changes since 10/04/93
  7.   - Some systems did not respond well to the WinDrawText.  This caused
  8.     WPSbkup to loop trying to set the fontsize.  Workaround was added
  9.     to trap this situation.  10 point fontsize is forced under these
  10.     circumstances.
  11.   - The system levels for OS/2 for Windows and the 2.1 Standard Edition
  12.     CSD were added to WPSbkup's recognised list.
  13.  
  14. Changes since 09/07/93
  15.   - Added the optional parameters NotifyOK and NoNotifyOK (default.)
  16.     The NotifyOK parameter may be placed after the specification of
  17.     the backup target directory on the command line or in the 
  18.     Parameters entry field of WPSbkup's program reference settings
  19.     notebook.  The NotifyOK parm causes WPSbkup to display an
  20.     informational message window just before it exits from a successful
  21.     backup run.  WPSbkup *always* displays error messages for any
  22.     reason that causes it to exit without creating a valid backup.
  23.     As always, a discription of WPSbkup syntax requirements can be
  24.     displayed by entering WPSBKUP from the command line with no input
  25.     parameters.
  26.   - The WPSrest.cmd was modified slightly to cut down on non-essential
  27.     messages displayed during restore.  Also, a new message is displayed
  28.     at the end of the restore process that instructs the PC user that
  29.     the restore is complete and a reboot is needed.
  30.   - Plugged a hole whereby WPSbkup would be unable to find the
  31.     desktop of OS/2 2.0 GA systems
  32.   - Added logic to more closely examine a display system's ability
  33.     to present a given font size in a specific target area.
  34.  
  35. Changes since 06/12/93
  36.   - WPSrest command generation is completely reworked.  It is
  37.     now possible to copy the backup target to any other location.
  38.     The restore process is no longer dependent upon the physical
  39.     location of the backup directory.  (The old approach required
  40.     that the backup directory be unchanged from the place of its
  41.     creation.)  However, now you must change to the backup directory
  42.     before executing the WPSrest.cmd restore command.  To relocate
  43.     the backup directory, use:
  44.         XCOPY D:\MYbackupDir\*.*  A:\MYBKDIR /s /e /v
  45.     If the backup directory is contained upon an HPFS volume, you
  46.     may also simply rename the directory to establish backup 
  47.     generation control:
  48.         REN D:\MYbackupDir  E:\MYbackupDir.old
  49.   - WPSbkup can now find your Desktop directory even if you move
  50.     it to a different drive or subdirectory.
  51.   - WPSbkup will not allow you to specify the Desktop directory as
  52.     a backup target.  This specification was accidentally made by 
  53.     several users while adding WPSbkup to the Desktop popup menu.
  54.     Since the first step of the backup process includes deleting all
  55.     of the entries in the target directory, allowing the Desktop 
  56.     directory to be specified as the target had dire consequences.
  57.     WPSbkup will ignore the Desktop path if it is found in the input
  58.     parameters.
  59.   - WipeWPS.exe is stored in the backup target directory during the 
  60.     backup process.  This removes any PATH requirements for the
  61.     restore procedure.  Formerly, I suggested that WPSbkup.exe and 
  62.     WipeWPS.exe be placed in the \OS2\INSTALL.  This is no longer
  63.     required.  These files may be placed in any directory with the
  64.     following provisions:
  65.        - They can't reside in the backup target directory
  66.        - They shouldn't reside in the physical Desktop Directory
  67.        - BOTH FILES MUST RESIDE IN THE SAME DIRECTORY
  68.   - WPSbkup has been given a new look.  The presentation code is
  69.     completely rewritten.  A new program icon has been assigned. 
  70.   - WPSbkup recognizes and has been tested with all levels of OS/2 up
  71.     to and including the S3 video support production release.    
  72.  
  73. Changes since 04/02/93
  74.   - Corrected an ambiguity in the creation scheme for the 
  75.     progress indicator that caused an error under OS/2 2.1 GA.
  76.   - Tested and validated under OS/2 2.1 GA.
  77.  
  78. Changes since 11/08/92
  79.   - Inserted ATTRIB command to remove potential ReadOnly flag
  80.     from INI being replaced during restore.  (3/93 beta)
  81.   - Added some performance/size parms to compile and link
  82.   - Changed WipeWPS from fullscreen to windowable
  83.   - Changed WipeWPS DosDelete to DosForceDelete
  84.   - Changed WipeWPS reply prompt from scanf to _getch to allow
  85.     use of minimal boot partition created for 2.1 by SE20boot
  86.   - Removed read.me section relating to long elapsed times.
  87.     (Thank you prf* API developers for 2.1!)
  88.  
  89. Changes since 11/02/92
  90.   - Fixed my own bug that occurred >63K record in OS2SYS.ini
  91.     Special thanks to Olaf Koch, Bruce Leiwant and Rick Yoder.
  92.   - WPSbkup release number now appears on the title bar
  93.  
  94. Changes since 9/18/92
  95.   - Bug workaround when >64K I/O area input to PrfQueryProfileData
  96.   - Version check recognises SP levels 6050 and 6055 
  97.  
  98. Changes since 7/4/92 
  99.   - 32 bit GRE beta level code tested and certified
  100.   - Bug workaround when 64K I/O area and enumerate appls
  101.   - DosForceDelete used to clear old target dir
  102.   - Wait pointer consistant over client area
  103.   - Progress indicator added for INI backups
  104.   - Enterprise registration now available
  105.  
  106. Introduction -
  107.  
  108. Thank you for trying WPSbkup.  WPSbkup is a 32 bit utility that will backup
  109. status and configuration data for the OS/2 2.x WorkPlace Shell (WPS).
  110.  
  111. The OS/2 WPS is the new and exciting object oriented user interface that
  112. accompanies the OS/2 version 2 operating system.  When you customize the WPS
  113. to suit your own need and taste, you are modifying two physical elements of
  114. OS/2.  These elements are:
  115.  
  116.   - The system initialization (INI) files, OS2.INI and OS2SYS.INI which
  117.     reside in the OS2 directory of the boot drive.  These INI files contain
  118.     the bulk of the system customization information.  They are opened for 
  119.     update immediately after boot.  The INI files are accessed through a set
  120.     of two indices.  Since these files are updated through "random access", 
  121.     data integrity using a sequential backup method can not be provided while
  122.     the INI files are open.  WPSbkup uses API calls provided by OS/2 for the
  123.     purpose of accessing INI files with integrity.  The INI integrity is 
  124.     critical for the successful operation of your system.  Remember that 
  125.     OS/2 is a multitasking system.  You can do real work while WPSbkup 
  126.     is active.
  127.  
  128.   - The desktop directory structure (DTP) and its associated extended attribute
  129.     (EA) data also holds a large amount of your customization data.  The DTP
  130.     is more visible to you because you directly manipulate its elements using
  131.     the OS/2 file system and WPS objective controls.  However, much of its
  132.     information is really stored in the INI files (see above.)  When you drag
  133.     a "Program object instance" out of the Templates folder, drop it on the
  134.     desktop and fill in execution related information you are interacting with
  135.     DTP.  However, almost all of the information that records this activity is
  136.     maintained in the INI files.  WPSbkup records enough information about the
  137.     DTP to be able to recreate it in a way that preserves its associations in
  138.     the INI files.  WPSbkup records the information in a way that allows you
  139.     to store the backup data on removable (floppy) FAT formatted media.
  140.  
  141. WPSbkup provides an alternative to the Alt+F1 procedure.  WPSbkup will provide
  142. backup data for your WPS and create a simple to use WPS restore procedure.
  143. More than likely you will never need to use the restore procedure, but if you
  144. do, it can save you hours of recovery time.  WPSbkup backs up only the data
  145. that "personalizes" your implementation of OS2 2.x.  WPSbkup has been tested
  146. with both US and National Language releases of OS2 version 2.  
  147.  
  148. WPSbkup can also be used in large organizations to install a standard WPS user
  149. interface for user machine that have identical (or VERY VERY similar) hardware
  150. configurations.
  151.  
  152.  
  153.  
  154. Contents of this package are:
  155.  
  156. Read.Me     - You're reading it right now.
  157. WPSbkup.exe - The Workplace Shell image copy utility.
  158. WipeWPS.exe - Clears out the desktop directorie(s) before recovery.
  159.  
  160.  
  161.  
  162. Installation is pretty darn simple:
  163.  
  164. Step1 - Copy WPSbkup.exe to a directory that you use to store programs.  Use
  165.         a directory OTHER THAN the OS/2 Desktop directory or any of its
  166.         subdirectories, though.  If a program is physically located in the
  167.         desktop directory structure AND that program is running when you
  168.         execute WPSbkup, then the backup will fail.
  169.  
  170. Step2 - Copy WipeWPS.exe TO THE SAME DIRECTORY AS USED ABOVE.
  171.  
  172. Step3 - Add a program entry to any of your folders for WPSbkup.exe.  As far
  173.         as program settings go, all you really have to specify is path and
  174.         file name for where you placed WPSbkup.exe and the name of the
  175.         target directory into which Workplace Shell backup data will be placed.
  176.  
  177.         Enter the name of the target directory in the Parameters entry field.
  178.         You must specify drive and full path name. (I.e. E:\WPSstore)  If this
  179.         directory does not exist, WPSbkup will create it when it executes.
  180.  
  181.         TAKE NOTE:  WPSbkup.exe owns the target directory lock, stock and
  182.                     barrel.  When it starts execution, it erases all files
  183.                     and sub-directories contained within its target directory.
  184.                     So don't specify a directory that holds any files or
  185.                     sub-directories that you wish to keep.
  186.  
  187. Executing the backup is as simple as double clicking the icon!  WPSbkup.exe
  188. is a well behaved 32 bit PM application.  It does its considerable I/O on a
  189. separate thread so that you can close it, minimize it or do other tasks while
  190. it is running.  After it completes execution, look at the Read.Me file that is
  191. created in the target directory.  This file will tell you exactly what must
  192. be done in the case of a Workplace Shell failure.
  193.  
  194. Miscellaneous Notes:
  195.  
  196. 1) To receive syntax help for WPSbkup, execute it with no parameters from
  197.    an OS2 command prompt.
  198.  
  199. 2) Optional Parameters:
  200.  
  201.    PurgePrompt | NoPurgePrompt    -  allows suppression of the confirmation
  202.                                      message box that warns of the erasure
  203.                                      of files and sub-directories in the
  204.                                      backup target.  Default is PurgePrompt.
  205.                                      Be advised that WPSbkup is running when
  206.                                      the WPS status is stored.  That means
  207.                                      that if you have to restore, WPSbkup will
  208.                                      be initiated for execution.  If you use
  209.                                      the NoPurgePrompt parameter, a superfluous
  210.                                      backup will be taken when you reboot after
  211.                                      a restore.
  212.  
  213.    TestVer2Rev | NoTestVer2Rev    -  allows suppression of the check made for
  214.                                      CSD XR02000_ or CSD XR02010_.  Use this
  215.                                      parameter if you have more current
  216.                                      maintenance and are sure that this backup
  217.                                      procedure will still work with your
  218.                                      revision.  Default is TestVer2Rev.
  219.  
  220.    NoNotifyOK  | NotifyOK         -  allows generation of an "all clear"     
  221.                                      message that indicates the backup      
  222.                                      completed successfully.  Default is
  223.                                      NoNotifyOK.  WPSbkup *always* reports
  224.                                      error conditions that might keep it
  225.                                      from being able to create a valid backup.
  226.  
  227. 3) Many checks are made to insure that you will be notified if valid backups
  228.    are not created.  However, image copies are created and the GIGO (garbage
  229.    in / garbage out) rule applies.  Therefore, make sure that you are running
  230.    cleanly before you write over backup data with a new backup.  Try to use
  231.    a rotating target directory methodology so that you can maintain a valid
  232.    -1 backup should the current backup data prove to be damaged.
  233.  
  234.  
  235. ================== SUPPORT SHAREWARE =====================================
  236.  
  237. I hope you find this utility helpful, but (here comes the disclaimer) I am
  238. in no way responsible for any damages the use of this utility may cause.
  239. You are free to use this utility at your own risk with no obligation to me,
  240. the author, for only a short period of time.
  241.  
  242. This backup utility will allow 15 trial executions.  Then it will "time out."
  243. If WPSbkup is helpful to you or your organization, you should register it.
  244. The registration fee for individuals is $15 (US).  The site registration fee
  245. for corporate entities is $150 (US).  Finally, an enterprise registration is
  246. available for organizations with more that ten branches or offices.  The 
  247. enterprise registration fee is $1500 (US).  Checks must be drawn upon US banks.
  248.  
  249. Please state the file date of WPSbkup.exe that you currently have (if any)
  250. in your registration letter.
  251.  
  252. Please send registration fees to:
  253.  
  254. Dave Lester
  255. PO Box 461
  256. New Freedom, PA. 17349 USA
  257.  
  258. Comments, suggestions and bug reports may be submitted through CIS Mail
  259. ID 75600,237.  These will be answered on a "best effort" basis.
  260.  
  261.